Readme for MaXware UA-FI Version 5.2.2


(C) 1994-2003 EDB Maxware AS
(C) 2004-2018 AddOnMail


Last Updated: March 2018




=============================================================
Installation Prerequisites:
=============================================================


	Microsoft Windows 32 bits/64 bits.
	Linux (Kernel 3.4.6 of higher, and openssl package, version 1.x or higher)
	HP-UX 10.20 or higher
	Solaris 2.8 or higher
	AIX 5.2 or higher
	
	

=============================================================
Installation.
=============================================================

Microsoft Windows
-----------------

First time installation of MaXware UA-FI:

- If you run Windows-NT, you must be logged in as a user with administrator permissions.

- Close Windows programs in use, and run A:\SETUP from disk1. This is an InstallShield
  setup program.
  First, you are asked for the Mail Service profile name and the UA-FI directory name (default
  C:\UAFIWIN). Since each profile supports a set of communication drivers (TCP/IP in this version), 
  you are asked for the communication parameters supported by the
  relevant profile. The installation job copies the relevant files to the UA-FI directory,  and the
  configuration files are updated.
  The log-file Install.log in the UA-FI directory is created during installation. You may take a
  look at this file by a text editor after installation.

- Create a user with the create-user command ( See the UA-FI Programmers Guide ).
  Sample files for doing this are enclosed as examples

- Create your own command-files, header-files and bodypart-files, and run UA-FI from a
  Command Prompt (DOS) window.
  See the UA-FI Programmers guide for detailed informations about how to use UA-FI.


Reinstallation of MaXware UA-FI:

- Run A:\SETUP from disk1. If you want to use the existing configuration, only the programs,
  examples and README files are copied. If not, you are prompted for UA-FI parameters in
  the same way as for first-time installation.

- Check that your command-files, header-files and bodyparts-files still works with the new
  UA-FI programs.


If you want to remove MaXware UA-FI:

- Run Add/Remove program from the Control Panel.



Linux of Unix
--------------------------
Copy all files in a directory.

UA-FI is a 32 bits binary, so on 64 bits OS, 32 bits libraries have to be present.
UA-FI needs following libraries : 
- OpenSSL 1.x

loguafi needs following librairies :
- libstdc++.so.5 (included in libstdc++33-32bit - The standard C++ shared library)
- libgcc_s.so.1



=============================================================
Files installed by the installation program.
=============================================================

Basic files
-----------
maxyy.msg       Message file for UA-FI. yy is the national ISI code.
maxware.ini    	UA-FI configuration file. 
ansi.chs      	Character mapping file for ANSI character set.
readme.txt	Simple information file used by the installation job.

Microsoft Windows
uafitc32.exe   	Executable for TCP/IP.

Linux
ua-fitcplinux
ua-fitcplinux2

Aix
ua-fitcpaix

HP-UX
ua-fitcphp

Solaris
ua-fitcpsol

Profiles
--------
There will be copied a set of *.prf, *.con, *.dis, *.tlp, *.mod files to the UA-FI
directory. The <selected-profile>.prf file may be updated during installation.

*.prf	Service profiles.
*.con	Connect scripts.
*.dis	Disconnect scripts.
*.tlp	Telephone locations
*.mod    Modem profiles

Example files
-------------
These files are copied to the subdirectory 'examples'. Copy the files to the UA-FI
directory if you want to run the examples.

create.cmd	Sample UA-FI command file for creating a new user.
fetch.cmd	Sample UA-FI command file for fetching messages in 
		the mailbox.
send.cmd	Sample command file for submitting a message.
header.hdr	Sample header file for submitting a message.
body.bdy	Bodypart submitted with the send.bat batch file.



=============================================================
Use MaXware UA-FI 
=============================================================


After installation, run UA-FI from a MS-DOS window (command prompt) or from a shell (Linux/Unix).
Go to the UA-FI directory, make your own command-files, header-files and bodypart-files, and run UA-FI:

UA-FI [<options>] <cmdfile> <respfile> <username> <password>

Options (all options are optional):
  -v  : Verbose, show trace info when UA-FI is run
  -path <path> : specify where the config.files MAXWARE.INI and MAX??.MSG are located
  -password <newpass> : New MS password

Replace UA-FI by the name of the binary (ua-fitcplinux, uafitc32.exe, ....)

See MaXware UA-FI Programmer's Guide for details.


Linux
-----
   To be compatible with Linux's distributions, the binary ua-fitcplinux2 is called by the ua-fitcplinux script. The goal of this script is to create some symbolics links to ssl library if need. The ua-fitcplinux script has to be used instead of the binary

Solaris
-------
   To use the UA-FI, it is necessary to add /usr/lib and /usr/ucblib to LD_LIBRARY_PATH
      LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/lib:/usr/ucblib
      
      export LD_LIBRARY_PATH



Example from the file <service>.PRF 

[Communication]
IPDriver=1
MS_IPAddress=123.321.123.321
MS_Address=/TSAP-ID=<tsap>/SSAP-ID=<ssap>/PSAP-ID=<psap>

Note that SAP is read from the line MS_ADDRESS and not from MS_IPAddress, and that the
fields are Case sensitive strings variables. 

Compatibility:

UA-FI for Windows should work well with all TCP/IP implementations supporting Windows Sockets
(WINSOCK) ver 1.1 or newer.
